home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / aprs60.zip / AUTOWX45.ZIP / AUTOWX.DOC next >
Text File  |  1994-08-01  |  17KB  |  368 lines
  1. AutoWx.EXE
  2. (C) 1994 N5KOA
  3. VER 4.x   7/94
  4.  
  5.  
  6. AutoWX (Auto-Weather) is an IBM compatible packet program that accepts
  7. weather data from the Ultimeter II weather station and makes the data
  8. available on packet by direct connect requests and/or via automatic
  9. beacons (in APRS beacon format).  The program assumes you are using two
  10. serial ports (COM1 and COM2) and that the U-II is connected to one, the
  11. TNC to the other.  Use ALT-H for online help.  The program works very
  12. well on an XT with 256K RAM and a single floppy disk drive.  XT's are
  13. often GIVEN away now days and one could be dedicated full time to this
  14. application.
  15.  
  16. Compatibility with earlier versions:
  17.  
  18. The WX.CFG file contains a logger filename as of version 3.x  Note the
  19. contents of your old WX.CFG for reference if you want, and rename or
  20. delete the old file.  Run AutoWx to create a new configuration file.
  21. Read PROGRAM UPDATES section of this documentation for new features.
  22.  
  23.  
  24. STARTUP / CONFIGURATION Parameters
  25.  
  26.   ---------------------------------------------------------------
  27. = THE ULTIITSR PROGRAM SHOULD NOT BE USED WHILE AUTOWX IS RUNNING =
  28.   ---------------------------------------------------------------
  29.  
  30. (The TNC ECHO should be ON, MONITOR OFF, AUTOLF OFF and MAXUSERS 1.)
  31.  
  32. The first time AutoWx is executed, or if the WX.CFG file is not found,
  33. the user is prompted for configuration information.  The COM port of the
  34. TNC must be identified as (COM) "1" or "2".  The other COM port will
  35. automatically be assigned to the Ultimeter II.
  36.  
  37. Supported baud rates for the TNC port are: 1200,2400,4800 & 9600
  38.  
  39. Your station's latitude and longitude are necessary to beacon in a format
  40. recognized by the Automatic Packet Routing System (APRS by WB4APR).
  41. There is very little error validation in the entry of the coordinates so
  42. be very careful that they are entered in the format shown at the config
  43. prompt.  Null entries at the Latitude and Longitude prompts will result
  44. in "0000.00N" and "00000.00W".
  45.  
  46. A temperature adjustment value is included because the Ultimeter II
  47. temperature sensor can be affected if additional lengths of cable are
  48. attached to it.  The default value for the temperature adjustment is 56
  49. which will be correct if the display on the U-II is correct.
  50.  
  51. Weather data can be tracked on the AutoWx screen in three different
  52. formats.  If you enter zero (0), the status line at the bottom of the
  53. screen will not show weather data but will show the last time someone
  54. connected and requested weather data and how many times weather has been
  55. requested since the program was last started.   A value of one (1) will
  56. cause weather data to be printed on the screen every time an update is
  57. performed.  (Usually every 5 minutes - see more information in this text
  58. when the update is discussed.)  A value of two (2) will cause the status
  59. line to be updated every time the program updates weather data.  (If your
  60. computer has more than 640K RAM you can use option 1 and scroll back
  61. through the data with the PC Magazine utility PERUSE.COM once in
  62. awhile.)  The default value is zero and entry of any value over two will
  63. revert to the value of two.
  64.  
  65. Note that when prompted for the Log File Name, your entry should NOT
  66. include an extension.  The extension .LOG is automatically added.
  67.  
  68. After the configuration information is entered, it is written to the
  69. ASCII file WX.CFG  The configuration can be changed either by deleting
  70. the file and running AutoWx or by editing the file.  NOTE - If you edit
  71. the WX.CFG file, remember the values for Temp Adjustment and Status
  72. Display Format are not in quotes - the others are.  Each element is
  73. separated by a comma.  Also, the WX.CFG file must be in the same
  74. directory as AutoWx.EXE.
  75.  
  76.  
  77. WX.DAT file
  78.  
  79. The WX.DAT file is an ASCII file that tracks the high and low
  80. temperatures and high wind speed for the day.  If the file is not
  81. present when AutoWx is executed it will be created.  The file is updated
  82. whenever the Hi's and Lo's are edited (ALT-E) and when the program is
  83. terminated with ALT-Q.  Actually you must answer the "write data" prompt
  84. with "Y" or "Yes" - the default (No) will not write the file.
  85.  
  86. The Hi's & Lo's can be edited by typing ALT-E during the program.  At
  87. that point you are prompted to enter  1,2 or 3 depending upon which item
  88. you want to change.  If you enter no value the edit is aborted and the
  89. program is back in the main loop.  If you change a value, enter the new
  90. information in the same format as displayed.
  91.  
  92. The Hi's & Lo's displayed with connected requests are in memory only and
  93. will be lost unless you write them to the data file when terminating the
  94. program or editing the file.
  95.  
  96. If you stop the program and restart it on the same date, the data in the
  97. WX.DAT file will be read and used by the program.  If the date in WX.DAT
  98. is different than the system date on your computer, the data will be
  99. ignored and new Hi's and Lo's will be tracked beginning with the first
  100. data read on the wx port.  At midnite new Hi's and Lo's are begun.
  101.  
  102. The first line of the WX.DAT file is a title included only to help you
  103. read the data when looking at the file with an editor or list program.
  104. The contents inside the quotes on the first line are totally irrelavent
  105. to AutoWx.
  106.  
  107.  
  108. UPDATE
  109.  
  110. As of version 4.x the U-II data is read continuously and logged to disk
  111. every 5 minutes.  Whenever the data is logged, it is also printed on the
  112. screen (if you selected option 1 or 2 in the configuration of the status
  113. line).  This feature can be toggled off with ALT-U but this will also
  114. disable the logging of data to the log file.  If you are going to
  115. disconnect or otherwise disable the weather input, toggle the updates
  116. off with ALT-U to keep the program from hanging up during the update
  117. sequence.  While the updates are toggled OFF, connected requests for
  118. weather (//wx) will receive a message stating that "Weather data is
  119. temporarily unavailable...".
  120.  
  121. When UPDATE is toggled, the timer is not reset so when UPDATE is
  122. toggled back ON, if the programmed time (5 min.) has passed while
  123. UPDATE was OFF, the update will be performed immediately.
  124.  
  125. If AutoWx is started with the command line parameter "/SHORT", the
  126. weather node response will NOT include hi/lo temps/wind.  Only the
  127. current weather data will be sent.  The startup syntax from DOS would
  128. be:             AUTOWX /SHORT
  129.  
  130.  
  131.  
  132. WEATHER NODE (for connected requests)
  133.  
  134. If another packet station connects and sends "//wx", (without the
  135. quotes - upper or lower case), AutoWx will update and send the current
  136. weather data and Hi's and Lo's for the day.
  137.  
  138. I include instructions in my Connect Text (CTEXT) showing:
  139.      "Send //wx for weather data..."
  140.  
  141. As of version 4 it is not really necessary for a user to request the
  142. weather info more than once because the wind speed will show the highest
  143. windspeed recorded since data was last logged to disk.  The report is
  144. displayed on screen if you enter the //wx directly from the keyboard but
  145. the TNC cmd: 's clutter the display.
  146.  
  147. (The program does not indicate wind chill but I will gladly add that data
  148. if someone will furnish me with an algorithm to calculate it from wind
  149. speed and temperature or from a table if the table is efficient.)
  150.  
  151. While a station is connected, the APRS Beacon is suspended.  Also, if
  152. UPDATES are OFF a connected user will see the message, "Weather
  153. data temporarily not available...".  The last ten stations that
  154. connected can be viewed by pressing the PgDn key.
  155.  
  156. Users may disconnect by sending //bye.
  157.  
  158.  
  159.  
  160. BEACONS
  161.  
  162. Automatic beacons can be toggled ON/OFF with ALT-B.  The beacon will be
  163. digi'd through any valid path specified in the UNPROTO tnc parameter.
  164.  
  165. When Beacon is toggled ON, the user is prompted for the interval (in
  166. minutes;  default = 30 minutes) and for any text to be tagged on the end
  167. of the weather data.  The Beacon time will be in the nearest 5-minute
  168. increment regardless of the value entered;  for example, if you enter 9
  169. minutes, the actual beacon time will be 10 minutes.  Beacons are
  170. transmitted only when the log file is updated.
  171.  
  172. The beacon will automatically include the Longitude and Latitude from
  173. the config file.   If you enter text to be appended to the beacon
  174. (Btext), it will be limited to 30 characters.
  175.  
  176. When the Beacon is ON, it can be forced to xmit immediately by typing
  177. ALT-T.
  178.  
  179. The Beacon can be turned off/on remotely with //BEACON.  Make sure that
  180. you have the correct path specified in UNPROTO.
  181.  
  182.  
  183. LOG File
  184.  
  185. Every 5 minutes the program updates the binary logfile named in the
  186. WX.CFG file.  This file can be read with the Ultimeter II Data Display
  187. program (Vers 1 & 2).   (Log files can be appended to each other by
  188. using the COPY /B command.  Example: copy /b file1.log+file2.log bigfile.log
  189. See your DOS manual for details on COPYing binary files.)
  190.  
  191. NOTE:  Logging is suspended while UPDATE is toggled OFF.
  192.  
  193. The U-II Data Display program assumes that all log entries are at five
  194. minute intervals.  Therefore, if you suspend logging for more than a
  195. couple of minutes, the Data Display program will be reading data that
  196. was logged after the time displayed in the Data Display program.  For
  197. example:  If you suspended the logger with ALT-U at 10:28 and did not
  198. resume logging until 10:58, the Display program will show the data
  199. logged at 11:00 as if it were logged at 10:30 and there will be thirty
  200. minutes of no data at the end of the day.  See Log File Notes for more
  201. information.
  202.  
  203. TERMINAL Mode
  204.  
  205. If you use the program as a packet terminal to connect to other
  206. stations temporarily, turn the Beacon OFF.  If UPDATEs are left ON, the
  207. logger will continue to log data but your screen will also continue to
  208. receive updated data every five minutes and the program will seem to
  209. halt while the U-II data is read.  The program will ignore the //wx
  210. request if you disable it with the ALT-X toggle.  If you plan an
  211. extended QSO, use another program.  AutoWx makes a lousy terminal
  212. program anyway.
  213.  
  214.  
  215. NOTES:                       
  216.  
  217. Log File Notes
  218.  
  219. The binary log file is much like the one created by the Ultimeter-II
  220. Data Logger and is very efficient.  You can probably get a whole year's
  221. data on a 360K floppy.  The AutoWx program must run for at least ten
  222. minutes before any useable data is logged.  Also, starting and stopping
  223. the AutoWx program before any useable data is logged can cause errors in
  224. the display.  The U-II Data Display program reads a file header in the
  225. log file to determine the starting date and time but all data entries
  226. after the header are assumed to be in five minute intervals.  The AutoWx
  227. program writes a new date/time header each time it starts but if logging
  228. is suspended by the ALT-U toggle the data may miss the 5 minute interval
  229. and therefore be incorrectly displayed by the U-II Data Display program.
  230. If the logger is suspended for more than 10 minutes, quit the AutoWx
  231. program and restart it to avoid the problem.  Although data may be
  232. missing for the suspended period, the data logged will be displayed with
  233. the correct time if you follow this procedure.   If the program fails to
  234. see a response from the U-II it will hang up and you will have to
  235. re-boot to recover.
  236.  
  237. The AutoWx program reads the Ultimeter II port continuously and, when
  238. logging, logs the highest windspeed recorded during the last 5 minutes.
  239. However, the U-II data sends serial data every 4 seconds (on average)
  240. but reads sensors about every 1.5 seconds and there may be differences
  241. in the high windspeed recorded on the U-II display and that recorded by
  242. AutoWx.
  243.  
  244.  
  245.                       --------------------------
  246.  
  247.  
  248.  
  249. AutoWx is released for the use by other licensed amateur radio operators
  250. and no payment or registration fees are necessary.  The program is
  251. copyright protected and I choose to retain all rights to the code.  The
  252. source code (QuickBasic 4.5) will not be made available unless somebody
  253. convinces me they can substantially contribute to the project.
  254.  
  255.  
  256. Comments and questions can be directed to N5KOA at N5RKN.#WTX (Odessa,
  257. TX).  Please drop me a line if you try the program.  Disk copies are
  258. available only when accompanied with enough green stuff to pay for the
  259. postage, disk, etc. DO NOT SEND DISKETTES!
  260.  
  261.  
  262.  
  263. Ultimeter II weather station sources:
  264.                         PEET BROS. as advertised in QST
  265.  
  266.                         Radio Com Sales  (Larry, N5VFW)
  267.                         Box 118814
  268.                         Carrollton, TX  75011
  269.                         (214) 492-3824
  270.  
  271.  
  272. APRS is a map-based packet program by WB4APR, Bob Bruniga, Annapolis, MD
  273. WXSTAT.EXE - a program to monitor Ultimeter II weather data in realtime.
  274.  
  275.  
  276.  
  277. PROGRAM UPATES
  278.  
  279. Ver. 1.x - allows only connected weather requests.
  280. Ver. 2.x - adds Updates to screen and Beacons
  281. Ver. 3.x - adds data logger
  282. Ver. 3.3f - allows list of last 10 connected stations with PgDn
  283.             CONNECT.LOG remains - see HELP screen
  284. Ver. 3.3g - tweaked timer routines
  285. Ver. 3.3h - Fixed config write routine
  286. Ver. 3.3i - sorts connected stations (listed with PgDn) by Date/Time
  287.  
  288. Ver. 4.x  - now reads and logs highest windspeed during the past five
  289.             minutes (reads wx data approx.  every 4 seconds)
  290.             quicker //wx response
  291.      4.2  - logging will synchronize to computer time (XX:X5 or XX:X0)
  292.      4.3  - Beacon interval will occur only with logging (5 minute
  293.             intervals)
  294.      4.3c - will abort if no U-II found on indicated port
  295.      4.3e - Hi's & Lo's written to ASCII file WX.HST
  296. Ver. 4.4a - fixes status line display for display option #2
  297.      4.5x - Tuned up log entries for rain amounts
  298.             Flush write buffer every hour
  299.             Removed ASCII file CONNECT.LOG
  300.             Allow null responses to Lat/Long entries in config
  301.      4.5d   Allow serial data starting with #  and allow /KPH startup
  302.             to correct windspeed  (see Errors/Bugs text)
  303.      4.5e   Fixed bug in 4.5d that caused Re-init errors
  304.  
  305.  
  306. Errors/Bugs
  307.  
  308. All versions after Ver 3.0 log data for the binary log file every five
  309. minutes but data is not physically written to disk until the write
  310. buffer is full (one disk sector).  If power to the computer is
  311. interrupted, any data in the buffer is lost.  As the program writes only
  312. 4 bytes (on average) at a time, 10 hours or more could be lost.  This
  313. problem is characteristic of DOS I/O and a suitable solution has not
  314. been determined yet.  To write the data every five minutes would result
  315. in, what I feel is, excessive drive wear.  I will continue to look for
  316. alternatives.  In the meantime, the buffer will flush every hour at 50
  317. minutes after the hour.
  318.  
  319. It has been reported that there are two versions of the U-II in regard
  320. to serial data output.  My U-II sends an asterisk (*) at the beginning
  321. of each data stream and there is apparently a version that sends the
  322. pound sign (#).  The (*) is supposed to indicate wind speed in MPH
  323. while the (#) indicates KPH.  If your U-II sends in KPH (#), start the
  324. AutoWx program with the switch /KPH.  Example:  AUTOWX /KPH
  325.  
  326. If you find a bug in the program, check for a later version on the ARRL
  327. BBS (201) 666-0578.  If the bug exists in the newest version please let
  328. me know so I can fix it.  I also welcome any suggestions or comments so
  329. please let me know if you like or dislike the program or if you would
  330. like to see other features added.  I will also consider customizing your
  331. version if you will pay for the disk and postage.
  332.  
  333.  
  334. Les Blalock, N5KOA
  335. 1711 Pagewood
  336. Odessa, TX  79761
  337. (915) 332-7112 day
  338.       332-1942 fax
  339.       367-0408 eve
  340.  
  341.  
  342.  
  343. TIPS
  344.  
  345. If you are using a hard drive, create a batch file that copies the
  346. WX.HST file and the xxxxx.LOG file and then EXITs.  Shell to DOS from
  347. AutoWx by typing Alt-D, type the name of your batch file, and the files
  348. can be copied to a floppy disk and the program resumed very quickly.
  349.  
  350. Find a HEX-to-BIN/BIN-to-HEX program  (I'll send one if you can't find
  351. one) and use the program to edit log files.  I create seperate log files
  352. for each month and, using the COPY /B command, I can make one for the year
  353. or any other particular time period.  Also, by working with smaller log
  354. files, you don't have to wait forever when running the Data Display
  355. Viewer program to graph your data.
  356.  
  357. Import WX.HST file entries to a database program and create custom
  358. statistical reports and graphs.  The WX.HST file is easy to import as a
  359. "comma-delimited ASCII file" into most popular database programs and
  360. many spreadsheet programs.
  361.  
  362. If a BBS in your town supports modem connections, consider leaving your
  363. weather node on the BBS frequency (or a gateway port) so the node can be
  364. accessed by telephone, too.
  365.  
  366.  
  367.  
  368.